SetThemeDrawingState

SetThemeDrawingState
Header:	Appearance.h		Carbon status:	Supported

Sets the drawing state of the current graphics port.

OSStatus SetThemeDrawingState (
    ThemeDrawingState inState, 
    Boolean inDisposeNow
);

inState: A value of type ThemeDrawingState. Pass a ThemeDrawingState value such as that produced in the outState parameter of GetThemeDrawingState.
inDisposeNow: A value of type Boolean. Pass a value of true to release the memory allocated for the drawing state reference. Pass false if you wish to continue using the drawing state and do not want to dispose of the memory at this time; you must call DisposeThemeDrawingState to dispose of the memory any time before your application terminates.

function result: A result code.

DISCUSSION

Your application can save the port state by calling the function GetThemeDrawingState and restore the port state by calling the function SetThemeDrawingState, supplying the value obtained in the outState parameter of GetThemeDrawingState, after you have completed all of your drawing.

VERSION NOTES

This function is available with Appearance Manager 1.1 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.